home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / ivd2dvi / doc < prev    next >
Text File  |  1990-10-01  |  3KB  |  61 lines
  1. NAME
  2.      ivd2dvi  -  convert a dvi-ivd file to a normal dvi file
  3.  
  4. SYNOPSIS
  5.      ivd2dvi [-Xv] [-b buffersize] [filename]
  6.  
  7. DESCRIPTION
  8.      An extension to TeX called TeX-XeT produces "dvi-ivd" files, which
  9.      are similar to dvi files but include nonstandard commands calling
  10.      for the "reflection" (horizontal reversal) of text.  In general,
  11.      dvi-ivd files cannot be processed by standard dvi drivers because
  12.      the reflection commands are not recognized.  ivd2dvi converts a
  13.      dvi-ivd file to an equivalent dvi file, that is, to a file in which
  14.      the necessary reflections are carried out using only standard dvi
  15.      commands.  The resulting file can be processed by any dvi driver.
  16.  
  17.      The dvi-ivd file to be processed is specified on the command line;
  18.      if the named file cannot be found and contains no period following
  19.      its rightmost slash, ".dvi" is appended and ivd2dvi tries again.
  20.      Unlike most dvi processors, ivd2dvi is a true filter and reads its
  21.      standard input if no file is specified.  The dvi file produced by
  22.      ivd2dvi is written to standard output.
  23.  
  24.      Since dvitype says only "unrecognized command!" about the reflection
  25.      commands found in dvi-ivd files, ivd2dvi also performs careful error
  26.      checking for proper use of these commands.
  27.  
  28. OPTIONS
  29.      -v   Verbose mode.  The number of each page is printed as it is 
  30.           processed.
  31.  
  32.      -b newbuffersize
  33.           Change the size of ivd2dvi's buffers.  ivd2dvi uses several
  34.           internal buffers and cannot proceed if any overflows.  When this
  35.           happens, you should try again using -b to increase the buffer
  36.           size.  The default buffer size is 1024.
  37.  
  38.      -X   Exact mode.  In this mode, ivd2dvi attempts to process the input
  39.           file without modification.  The comment string is not updated,
  40.           NOP commands are retained, and the maximum stack depth is copied
  41.           from the input file if possible (this number is conservatively
  42.           but imprecisely computed by TeX; normally ivd2dvi will substitute
  43.           the exact value).  As a result, dvi files with no reflection
  44.           commands are more likely to emerge totally unchanged.  Use of
  45.           this flag is discouraged except for debugging.
  46.  
  47. ENVIRONMENT
  48.      TEXFONTS
  49.           Colon-separated list of directories to be searched for font
  50.           metric files.  The default is /usr/lib/tex/fonts.
  51.  
  52. FILES
  53.      /usr/lib/tex/fonts/*.tfm        Font metric files.
  54.  
  55. SEE ALSO
  56.      "Mixing right-to-left texts with left-to-right texts," Donald Knuth
  57.      and Pierre MacKay, TUGboat volume 8 (1987), number 1, pp. 14--25.
  58.  
  59. AUTHOR
  60.      Larry Denenberg, larry@bbn.com or larry@harvard.edu.
  61.